home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / printstatus.z / printstatus
Text File  |  1998-10-30  |  15KB  |  264 lines
  1.  
  2.  
  3.  
  4. PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))                  PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                  PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      printstatus - graphical printer status tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      pppprrrriiiinnnnttttssssttttaaaattttuuuussss [ options... ] printername
  13.      PPPPrrrriiiinnnnttttSSSSttttaaaattttuuuussss is an alias for pppprrrriiiinnnnttttssssttttaaaattttuuuussss
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _p_r_i_n_t_s_t_a_t_u_s, also known as _P_r_i_n_t_S_t_a_t_u_s, provides a graphical interface
  18.      for monitoring printers under the AT&T System V print spooling system.
  19.      The program can be displayed on 24-bit, 8-bit, and 1-bit X displays.
  20.  
  21.  
  22.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  23.      -_e _u_p_d_a_t_e_I_n_t_e_r_v_a_l
  24.                     Specifies the interval, in seconds, between updates of the
  25.                     printer engine status information.  This includes the icon
  26.                     itself and the Current Printer Status area of the
  27.                     interface.  This information is polled whether _p_r_i_n_t_s_t_a_t_u_s
  28.                     is iconified or not.
  29.  
  30.  
  31.      -_q _u_p_d_a_t_e_I_n_t_e_r_v_a_l
  32.                     Specifies the interval, in seconds, between updates of the
  33.                     printer request queue status.  This includes the queue
  34.                     itself; the information in the "Printer Request Queue"
  35.                     area of the _p_r_i_n_t_s_t_a_t_u_s window.  This information is NNNNOOOOTTTT
  36.                     polled when the _p_r_i_n_t_s_t_a_t_u_s is iconified.
  37.  
  38.  
  39.      -_s _u_p_d_a_t_e_I_n_t_e_r_v_a_l
  40.                     Specifies the interval, in seconds, between updates of the
  41.                     spooler system status.  This includes the general spooler
  42.                     information, including whether the spooler queue for this
  43.                     printer is enabled or disabled.  This information is NNNNOOOOTTTT
  44.                     polled when the _p_r_i_n_t_s_t_a_t_u_s window is iconified.
  45.  
  46.  
  47.      -_i_c_o_n_i_c        A very useful method of invoking printstatus is either to
  48.                     invoke it with the  -_i_c_o_n_i_c X Toolkit option or to iconify
  49.                     it once running.  When iconified, _p_r_i_n_t_s_t_a_t_u_s continues to
  50.                     monitor the printer, and the application icon will change
  51.                     to reflect the current printer state.  If the icon
  52.                     displays an undesirable state, opening the icon will give
  53.                     detailed information on the printer's condition.
  54.  
  55.                     When iconified, _p_r_i_n_t_s_t_a_t_u_s performs only the minimal
  56.                     amount of polling necessary to keep the icon updated
  57.                     properly.  Therefore, iconifying _p_r_i_n_t_s_t_a_t_u_s is good
  58.                     etiquette when monitoring shared network printers, as the
  59.                     iconified _p_r_i_n_t_s_t_a_t_u_s generates very little load on your
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))                  PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                  PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))
  70.  
  71.  
  72.  
  73.                     network and on your network host.
  74.  
  75.  
  76.      _p_r_i_n_t_e_r_n_a_m_e    Specifies the printer that is to perform the printing.
  77.                     _p_r_i_n_t_e_r_n_a_m_e specifies the printer name. If the _p_r_i_n_t_e_r_n_a_m_e
  78.                     option is not specified then the printer selected will be
  79.                     the value of the LLLLPPPPDDDDEEEESSSSTTTT environment variable. If LLLLPPPPDDDDEEEESSSSTTTT is
  80.                     not set, the system default printer will be selected. If
  81.                     there is no system default printer, an error message to
  82.                     that effect will be printed and the program will exit.
  83.  
  84.  
  85.    PPPPrrrrooooggggrrrraaaammmm UUUUssssaaaaggggeeee
  86.      The _p_r_i_n_t_s_t_a_t_u_s program presents a status panel that consists of four
  87.      main areas. These areas are the menu bar, the printer information and
  88.      icon area, the printer status message area, and the printer queue area.
  89.      These areas are described below.
  90.  
  91.  
  92.      MMMMeeeennnnuuuu BBBBaaaarrrr   The menu bar provides four submenus: _P_r_i_n_t_e_r, _Q_u_e_u_e, _O_t_h_e_r
  93.                _T_o_o_l_s, and _H_e_l_p.
  94.  
  95.  
  96.                The _P_r_i_n_t_e_r menu contains options to send a test page to the
  97.                printer, to request that the printer status be updated
  98.                immediately, and to quit the program.  Note that the test page
  99.                will not be affected by any printer-specific settings you may
  100.                have set using the _P_r_i_n_t_P_a_n_e_l tool.
  101.  
  102.  
  103.                The _Q_u_e_u_e menu contains options to cancel jobs and to modify
  104.                queueing options.  To cancel a job, select that job in the
  105.                queue, and then select the cancel job menu option.  If the job
  106.                you select was not submitted from your workstation, the cancel
  107.                job menu choice will be disabled.  To set queueing options, you
  108.                must be running the tool as the system adminstrator.  To toggle
  109.                job acceptance for the local printer queue, simply select the
  110.                menu choice _P_r_i_n_t_e_r _A_c_c_e_p_t_i_n_g _Y_o_u_r _J_o_b_s and the state of that
  111.                function will be toggled.  To toggle job printing for the local
  112.                printer queue, simply select the menu choice _P_r_i_n_t_e_r _P_r_i_n_t_i_n_g
  113.                _Y_o_u_r _J_o_b_s and the state of that function will be toggled.  The
  114.                state of these toggle buttons is automatically updated at set
  115.                intervals in case the printer queue is modified from outside
  116.                _P_r_i_n_t_S_t_a_t_u_s.
  117.  
  118.  
  119.                The _O_t_h_e_r _T_o_o_l_s menu allows you to launch other printing-
  120.                related tools, such as the _P_r_i_n_t_P_a_n_e_l for submitting jobs and
  121.                setting printer-specific options, _P_r_i_n_t_M_a_n_a_g_e_r for adding and
  122.                deleting printers, and _P_r_i_n_t_S_t_a_t_u_s for another printer.  If any
  123.                of these programs is not properly installed, its menu entry
  124.                will be greyed out.
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))                  PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                  PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))
  136.  
  137.  
  138.  
  139.                The _H_e_l_p menu allows you to launch an online help dialog, which
  140.                should provide helpful information.  It better, or it isn't
  141.                doing its job.
  142.  
  143.  
  144.      PPPPrrrriiiinnnntttteeeerrrr IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn AAAAnnnndddd IIIIccccoooonnnn AAAArrrreeeeaaaa
  145.  
  146.                The top left portion of the _p_r_i_n_t_s_t_a_t_u_s main panel contains the
  147.                printer status icon, and the top right contains several lines
  148.                of information about that printer.  The icon graphically
  149.                displays the current state of the printer being monitored.
  150.                There are three states:  Idle, Printing, and Faulted.  The idle
  151.                state is indicated by a plain printer icon on a green
  152.                background.  The Printing state is indicated by a printer icon
  153.                plus a stack of waiting paper on a yellow background.  The
  154.                faulted state is indicated by a broken printer on a red
  155.                background.  (See the PPPPrrrriiiinnnntttteeeerrrr SSSSttttaaaattttuuuussss MMMMeeeessssssssaaaaggggeeee AAAArrrreeeeaaaa description
  156.                below for more detailed status.)
  157.  
  158.  
  159.                The textual printer information presented is the name of the
  160.                printer as known to your local spooler, the model and type of
  161.                printer as it was installed on the printer host, and the method
  162.                of connection.  If the printer is locally connected, a device
  163.                such as '/dev/plp' will be listed here.  If the printer is a
  164.                remote printer connected to another system, the name of that
  165.                host system will be listed.
  166.  
  167.  
  168.      PPPPrrrriiiinnnntttteeeerrrr SSSSttttaaaattttuuuussss MMMMeeeessssssssaaaaggggeeee AAAArrrreeeeaaaa
  169.  
  170.                This area contains two major features.  First is the current
  171.                printer state, which is one of _I_d_l_e, _P_r_i_n_t_i_n_g, or _F_a_u_l_t_e_d.
  172.                These states correspond to the green, yellow, and red icons,
  173.                respectively.  Detailed printer status information is presented
  174.                in the scrollable list immediately below.  Look in this area to
  175.                determine what the nature of the faulted condition may be.
  176.                Common problems such as out of paper or offline are easily
  177.                diagnosed from where you sit using this information.
  178.  
  179.  
  180.                If the printer you are monitoring is not an _I_m_p_r_e_s_s_a_r_i_o
  181.                printer, it may not be capable of reporting this detailed
  182.                status.  In that case the icon and the status area may not ever
  183.                change, and a message to that effect will be placed in the
  184.                status area.  In this case you may find it useful to resize the
  185.                status list area by dragging the lower sash up to the upper
  186.                sash, thereby conserving screen real estate.  You may also wish
  187.                to upgrade the printer server to an _I_m_p_r_e_s_s_a_r_i_o printer server
  188.                to obtain the detailed feedback which that package provides.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))                  PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                  PPPPRRRRIIIINNNNTTTTSSSSTTTTAAAATTTTUUUUSSSS((((1111))))
  202.  
  203.  
  204.  
  205.      PPPPrrrriiiinnnntttteeeerrrr QQQQuuuueeeeuuuueeee AAAArrrreeeeaaaa
  206.  
  207.                The jobs currently in the queue for this printer are displayed
  208.                here.  To cancel a job, select that job and then pull down the
  209.                queue menu, releasing your mouse button on the Cancel Selected
  210.                Job entry.  If you are running the tool as the administrator,
  211.                you may also be provided with the opportunity to forward the
  212.                job to another printer.
  213.  
  214.  
  215. PPPPRRRROOOOGGGGRRRRAAAAMMMM RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  216.      _p_r_i_n_t_s_t_a_t_u_s is written using the standard X toolkit and the Motif widget
  217.      set. The program accepts all standard Xt/Motif resources and command line
  218.      options.
  219.  
  220.  
  221. NNNNOOOOTTTTEEEESSSS
  222.      _p_r_i_n_t_s_t_a_t_u_s submits test jobs only to the AT&T System V print spooler.
  223.      The BSD spooling system is not currently supported.
  224.  
  225.  
  226.      _p_r_i_n_t_s_t_a_t_u_s by default updates the status information every 5 seconds,
  227.      the queue every 15 seconds, and the general information such as the
  228.      presence of the _O_t_h_e_r _T_o_o_l_s menu entries and queueing state (enabled,
  229.      accepting) every 30 seconds.  These values may be changed by specifying
  230.      the -_e, -_q, and -_s options.  Remembering that these values are polled at
  231.      set intervals may be helpful in understanding why some status updates are
  232.      not immediate.  Selecting _U_p_d_a_t_e _P_r_i_n_t_e_r _S_t_a_t_u_s immediately updates all
  233.      three classes of status information, without resetting any of the other
  234.      timers.
  235.  
  236.  
  237. KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGGSSSS
  238.      _p_r_i_n_t_s_t_a_t_u_s polls for spooler information by using _l_i_b_s_p_o_o_l(_3), which,
  239.      because of limitations in the System VR3 spooler, must use _r_s_h_d(_1_M) to
  240.      query remote spooler information.  If your printer host has access
  241.      logging turned on, this polling behavior can result in large system log
  242.      files if users leave their printstatus windows around for long periods.
  243.      The proper solution to this is to iconify your _p_r_i_n_t_s_t_a_t_u_s windows:
  244.      _p_r_i_n_t_s_t_a_t_u_s does not use _r_s_h_d(_1_M) to query engine status (see -_e switch,
  245.      above), and thus will not log accesses on the printer host.  Iconifying
  246.      _p_r_i_n_t_s_t_a_t_u_s generates the lowest resource utilization: all engine status
  247.      queries are done via the highly efficient RPC mechanism inside _l_i_b_p_o_d(_3).
  248.  
  249.  
  250. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  251.      lp(1), lpadmin(1M), PrintPanel(1)
  252.  
  253. FFFFIIIILLLLEEEESSSS
  254.      /usr/lib/X11/app-defaults/Printstatus    Program resource file
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                                                         PPPPaaaaggggeeee 4444
  261.  
  262.  
  263.  
  264.